Obter uma chave de API
App: Minotaur Sales API
Publicado por: Minotaur Sales
Compatível com: app.minotaursales.io
As chaves de API são gerenciadas na sua conta Minotaur. Você pode gerar uma chave diretamente pelo app ou via API.
Gerar pelo app
A forma mais simples de criar uma chave de API é diretamente pelo app Minotaur:
- Faça login em app.minotaursales.io.
- Acesse Configurações → Conexões → API Key.
- Clique em Gerar.
- Insira um nome e selecione um período de expiração (
7,30,90ou365dias). - Selecione as permissões que a chave precisa.
- Clique em Confirmar. Copie a chave — ela é exibida apenas uma vez.
Chaves geradas pelo app funcionam de forma idêntica às criadas via API.
Gerar via API
Os endpoints abaixo requerem um token de sessão (Bearer <session_token>).
Criar uma chave
POST /api/api-key/generate
Authorization: Bearer <session_token>
Content-Type: application/json
{
"name": "Minha Integração",
"expiration": 30
}
Valores aceitos para expiration: 7, 30, 90, 365.
Listar chaves
GET /api/api-key
Authorization: Bearer <session_token>
Retorna os registros de chaves, nunca o valor bruto da chave.
Atualizar ou rotacionar uma chave
PATCH /api/api-key/update/:id
Authorization: Bearer <session_token>
Content-Type: application/json
Pode atualizar name e/ou expiration, e emite uma nova chave.
A chave anterior para de funcionar imediatamente.
Revogar uma chave
PATCH /api/api-key/revoke/:id
Authorization: Bearer <session_token>
A revogação é permanente e não pode ser desfeita.
Notas importantes
- O valor da chave aparece apenas uma vez ao gerar/rotacionar.
- Salve as chaves em um gerenciador de segredos.
- Para mudar permissões, rotacione a chave.